home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / ums_qwk0.zip / QWK-UMS.DOC next >
Text File  |  1993-11-29  |  4KB  |  123 lines
  1.     QWKImport 0.27
  2.     QWKExport 0.7            for UMS 10.7+
  3.          by Iain Hibbert           by Martin Horneffer
  4.  
  5.   First, sorry about the skimpy documentation: I trashed my hard disk
  6. recently, and lost the original documentation and the source code to both
  7. programs. I shall be rewriting them sometime soon.
  8.  
  9.   QWKImport and QWKExport are a pair of programs to enable you to use your
  10. Favourite UMS NewsReader as an OLR for QWK mail.
  11.  
  12. Usage.
  13. ------
  14.  
  15.  QWKImport SITE/A
  16.  
  17.     SITE is the qwk site to import from
  18.  
  19.     QWKImport unpacks the bundle named <SITE>.QWK from the Inbound
  20.   directory, and scans the CONTROL.TXT file for Conference names.. then it
  21.   scans the MESSAGES.DAT file for messages and writes them to groups named
  22.   "qwk.<SITE>.<number> `Conference Name'"
  23.  
  24.     NOTE, there is no message threading information in QWK packets, so you
  25.   are limited to subject searches
  26.  
  27.  QWKExport SITE/A
  28.  
  29.     SITE is the qwk site to export to
  30.  
  31.     QWKExport scans your messagebase and writes the messages to a file
  32.   called <SITE>.MSG, which it then compresses into <SITE>.REP using your
  33.   specified packer and Outbound directory.
  34.  
  35.     NOTE, QWKExport gets the area number from the conference name, so you
  36.   will get problems if you try to export mail in areas not from the
  37.   original BBS
  38.  
  39. Configuration.
  40. --------------
  41.  
  42.     There are several UMS qwk. variables to specify
  43.  
  44. qwk.inbound    ; Where to find the .QWK bundles
  45. qwk.outbound    ; Where to put the .REP bundles
  46.  
  47. qwk.keeppacket    ; if "Yes", the QWK bundles are not deleted after processing
  48.  
  49. qwk.packer    ; command to use when packing the .MSG file into the
  50.         ; .REP bundle. Should contain two %s strings, the first is the
  51.         ; name of the archive, the second is the file to compress
  52.  
  53. qwk.unpacker    ; command to use when unpacking the .QWK file to the temporary
  54.         ; directory, should contain to %s bits, the first is the name
  55.         ; of the bundle, and the second is the temporary directory
  56.  
  57. qwk.tempdir    ; where to unpack the .QWK file to
  58.  
  59. Example.
  60. --------
  61.  
  62. qwk.inbound          = "Comms:Downloads/"
  63. qwk.outbound          = "Comms:Uploads/"
  64. qwk.keeppacket          = "No"
  65. qwk.tempdir          = "T:Qwk/"
  66. qwk.packer          = "LhA -I -u -m -U2048 m %s %s"
  67. qwk.unpacker          = "LhA -I -m -f -x0 -U8192 x %s %s"
  68.  
  69. User
  70.     Name  "Highlander BBS"
  71.     Alias "qwk.highland"
  72.     Distribution    = "#?"
  73.     Export        = "highland@qwk"
  74.     GroupFilter     = "#?"
  75.     Import        = "highland@qwk"
  76.     NetAccess        = "%"
  77.     Password
  78.     ReadAccess        = "qwk.highland.#?"
  79.     WriteAccess     = "qwk.highland.#?"
  80. EndUser
  81.  
  82. ToDo.
  83. -----
  84.  
  85.     Rewrite it, obviously
  86.  
  87.     another variable qwk.addpacket, which says whether to add to the .REP
  88.     bundles in your outbound or replace them (currently only replace is
  89.     supported)
  90.  
  91.     more command line switches (KEEP/S for Import and ADD/S for Export)
  92.  
  93.     QWK doesn't do netmail at all, most BBS's use a separate fake area for
  94.     netmail. We could do with throwing mail from this area (or areas)
  95.     into the Mail group ("") and export from Mail to the mail area.
  96.  
  97.     rewrite documentation
  98.  
  99.     more command line switches (PASSWORD)
  100.  
  101.     any other suggestions to the author
  102.  
  103. Copyright.
  104. ----------
  105.  
  106.      QWKImport and QWKExport are (C) 1993  Iain  Hibbert  and  are  freely
  107.  distributable as long as all of the files are included in their  original
  108.  form without additions, deletions, or modifications of any kind, and only
  109.  a nominal fee is charged for its distribution.
  110.  
  111.      This software is provided "AS IS" without warranty of any kind, either
  112.  expressed or implied. Reading Legal mush can turn your brain to guacamole.
  113.  By using QWKImport and QWKExport, you accept either the whole risk or    the
  114.  quality and performance of the program.
  115.  
  116. Author.
  117. -------
  118.  
  119.       Iain Hibbert         UUCP:    plunky@closet.wizdom.royle.org
  120.                  FidoNet:    2:255/171.33
  121.                  AmigaNet:    39:136/1.33
  122.  
  123.